home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Turnbull China Bikeride
/
Turnbull China Bikeride - Disc 2.iso
/
BARNET
/
STRAYLIGHT
/
README
< prev
next >
Wrap
Text File
|
1998-01-29
|
4KB
|
105 lines
STRAYLIGHT SOURCE RELEASE
~~~~~~~~~~~~~~~~~~~~~~~~~
This directory contains the Straylight Source Release. The various Zip
files contain sources to distinct pieces of software. Unfortunately,
the code was never written to be distributed, so there's a complex
pattern of interdependency between some of the packages.
`Phase 1' of the Release consists of the following parts:
Core Contains standard libraries and build tools required for
building everything else.
Dynamite Straylight's dynamic area management module. Requires
Core.
MiscToys Some fairly silly utilities. Requires Core.
Sapphire A large library for writing applications in ARM
assembler. There's a `README' file providing a brief
overview, documented header files and a few examples.
Requires Core, SDLS, and Sculptrix
Sculptrix A module for drawing 3D buttons. Requires Sapphire for
the configuration program.
SDLS Straylight's dynamic linking system. Requires Sculptrix.
Phase 2 will contain some more toys, the Steel C library, and the Glass
template editor. I'm not making any promises with regard to release
times for phase 2.
Building the SSR should be fairly straightforward. First, unpack the
sections you want. They all share the same build root directory
`StraySrc'.
Now, make sure that the environment is set up properly. I tested the
Release using a minimal toolset consisting of:
* The following programs available in Run$Path:
amu Acorn's Make Utility version 5.02
cc The Acorn C compiler version 5.06
ccrunch A BASIC compactor written by Ragnar Hafstað
libfile Acorn's library management tool version 5.00
link Acorn's linker version 5.06
o-cc An old Acorn C compiler version 4.00
o-libfile An old Acorn library management tool version 4.00
o-link An old Acorn linker version 4.00
o-objasm An old Acorn assembler version 2.00
objasm Acorn's ARM assembler version 3.06
sed GNU sed version 2.03
squeeze Acorn's AIF squeezer version 5.00
unzip InfoZIP unarchiver version 5.13c BETA
zip InfoZIP archiver version 2.0j
* The following libraries available in C$Path:
clib Acorn's C library headers
risc_oslib Acorn's RISC OS library headers and object files
You may be able to get away with different versions of tools. In
particular, the old versions of Acorn's tools are used to ensure
that AOF2 is generated for compatibility with other people's old tools.
SSR requires its own tools and libraries in addition to those listed
above. It will create `Libs$Path' pointing at its own libraries, and
add its own tools to `Run$Path' when you run `ssr-init'.
To build everything, run
amu
amu install
in the `StraySrc' directory. This will recursively build and install
everything you've unpacked. (The Makefiles work out which bits you've
got and build them.) If this doesn't work, make sure you've got all
the tools you need, and all the paths are set up right.
All the source code may be modified and redistributed under the terms of
the GNU General Public License, which is included in the distribution
archives as `StraySrc.COPYING'. Special exceptions for distribution of
binaries may be given; please ask me for permission.
Public discussion of the Straylight Source Release, including reporting
of bugs, and requesting new features, will take place on a mailing list.
To subscribe, send mail to `ssr-subscribe@excessus.demon.co.uk'. You
will be asked to send a confirmation message to prove that you can
receive mail from the list. To send a message to the list, mail
`ssr@excessus.demon.co.uk'.
I want to gather a small team of developers to continue maintenance of
SSR. If you think you could help to maintain and develop parts of SSR,
or write documentation for it, then send me email.
My personal email address is mdw@excessus.demon.co.uk. Please try to
report problems or requests to the list. (On the other hand, problems
/about/ the list probably ought to be sent to me!)
I think that about wraps it up for me.
Mark Wooding
Fri 30th January 1998